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Chapter One 

INTRODUCTION 


This book and the- accompanying cassetta contain the details ol N05- 
BAStCODE It has been designed as a standard for software e*Cl"i&nge 
between diHeremt brands of computers. These include some c A the most 
popular brands being used in many diflerent parts ol the wo r ld 

APPLE II A lie TRS-aO 

BBC Models A Si B VIC 20 

Commodore 64 Videogenie 

Sharp MZ80A ZKS1 

Side 1 or the cassette contains the various translation programs, each 
specific Ip a particular brand of computer, in simple terms you hr&l teach 
your computer the BASICODE standard tiy loading the translation 
program, then you can read arid write, using the standard, instructions on 
hpw Iq do 1h*s are contained in the rollowing chapters. 

Of course, ifs possible that your brand of home computer is not listed. If so. 
in Chapter Four, the BASlCODE protocol s described, which will no) p you 
compile a translation program for your computer. Naturally, you will need 
some programming e*per»ence, but II you succeed, tel us Know so we can 
(hen include it in luture editions at this handbook. Translation programs 
should Pe sent to us on cassette with a ponied listing (I possible, The 
address is The Chip Shop. BBC, London W1 A 1 AA. 

Programs following the BAStCOOE protocol ere also welcome These may 
be used on itie ai-r so that others can benefit. Credit will be given to the 
author, 

■I «s important to stress that BASICOOE has been produced on an entirely 

non profit-making basis. 

It has its origins in the weekly radio programme HobbyscQQp which is 
broadcast by tee Dutch domestic service. Nederiandse Qmroep Stichiinq 
INOS). 

HottbySCOOfi iransmi tied Its First computer program n 1&7&, at which point 
many listeners wrote 1o ask if there was something wrong with their rado 
receiver! The Follow ng year computer data was transmitted each week in 
cooperation w th TEL EAC which is roughly equivalent to the Open univer- 
sity. 
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At that lame four brands of Computer were popular Apple. Exidy Sorcerer. 
PET end Tandy TRS-SU Each compuier therefore dad Its own week in ihe 
month when maehine^readable data could be transmitted. But this ted to 
problems igr the broadcasters Two- of the computers used a very stow 
baud rale which meant that jhtaift'pAnf programs took up ra^ too much 
airtime on a national radio network. Up to eight minutes of obtodtonable 
noises was loo much even Tor the enthusiasts! Added to- this, the cassette 
Systems proved to be rather unreliable on twp of tbe four computers. Only 
a very small group of the Oulch computing public was being reached at any 
one time. 

tfiass Adders, who cs a well-known inventive rad»o amateur in The 
Netherlands, then came up wilh an interesting proposal. This involved me 
crealion of a typo of Computer Esperanto which could be read and written 
by various home computers. A group of computing hobbyists got together 
and BASICODE was ihe result ©l many months ot research Laler, when ihe 
limitations of Ihe First BASICODE were recognised, Atoas RoPers, together 
with Jqchem Herrmann, developed the improved BASICODE 2- This has 
now been m regular on-a»r use smoe January 1st 

It was soon discovered that the Dutch medium wave signal was reaching 
Outside the Dutch borders. Letters came from Computer enthusiasts -n 
England, Germany, Belgium, France and Denmark asking for mgre in I or* 
motion Further international interest was created when the Dutch external 
service, which broadcasts worldwide on shod wave, tgglk an inleresl in 
BASICODE. Ttie Thursday English language programme Matoa Network 
ran U feature Dn the code. They also Iried a series ol popular experiments 
with a slowed down version qI BASICODE running at 300 Baud, The data 
went out on short wave and listeners within 1.200 miles ot the transmitters 
reported success. 

The weekly Wpbbyscoop programme 15 in Dutch, naturally, but it can be 
received in some pads of the UK It can be heard on Sundays at 1810 GMT 
n winler, 1710 GMT in the summer mpnlhg, on medium wave 747 kHz* or 
40i metres Because listeners In Denmark, Belgium. Southern Britain and 
Weil Germany can load BASICODE programs from medium wave without 
problems the compiler segmenl gl (he programme (around 104&or 1740 
GMT), now includes short cxfUanabons in English, ir you are in range of the 
medium wave broadcasts, tune in and see sT you can receive them 

Apart from the people named above who nave been involved wilh the 
success of BASICODE, many Individuals in The Netherlands ihave helped 
us m ihe production ol translation programs and, in some cases, hardware 
designs, we thank ihem. 


Chapter Two 

HOWTO USE BASICODE-2 


BASIC ODE -2 was developed because different micro-computers not only 
speak ditfererat dialects or BASIC, but also record or .save the programs 
onto cassette in diflereni ways, Ail micro-corn pulers that use cassettes 
record their programs as a series oi bleeps but different machines use 
different fnequenc*es end various methods gt coding. BASICODE 2 is en 
audio encoding standard that can be used to store and retrieve software 
and can be used with a large number Of micro-computers. Once a micro- 
computer has been taught BASICODE-2 It can then run programs written 
on dittererit makes ol micro-computer. The only problem that remains is 
the ditierenges In BASIC dialed but BASICODE-2 agam gives us the 
solution. Our Compuier Esperanto interprets the program instructions so 
that they will work on all the micro-computers listed in Chapter One. This 
does mean that if you want to write programs for BASlCODE-2 you should 
write them according to some simple rules. You will tind these in the 
chapter written specif ieally for your micro. 

Hew tg load BASIC O D E 2 

On the lirst side ol Ihe tape you wm find a number of different versions of 
BASICODE 2. They are each preceded by an introduction. SO Find the one 
for your micro-computer and load ll In ihe 1 normal way There will be some 
special points to bear in mind lor your particular computer so refer to the 
relevani chapter for lull details. 

Once you have loaded BASICODE 2 ypu are ready l© try Out Sdme 
BAStCQDE-2 programs. On the second side of the tape you will find some 
demonstration programs To load one oF Ihese programs you should follow 
the mslruetions on the screen and also, lor some micros, refer io the 
instructions in ihe relevant chapter. Whan the program starts loading you 
will see the program be«ng listed on the screen, You will be able to check 
the program lor errors and make corrections before running it. 

Wow lhat BASICODE- 2 is tunning on your micro here's now you can use 
the Chip Shop programs. 

Chi p Shop Takeaway 

The Takeaway service allows you to gel software from your radio. The BBC 
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'5 broadcasting software laie at night on Radio 4. Check in Ihe Radio Times 
lor detail of transmission Dimes The software being transmitted is written, 
m BASICODE £. so. armed wilh ihe translation iape, yog will be able to run 
Ihe programs on your miorg. 

To make sure lhal the programs run property you need to make a good 
recording. Here are some tips; 

1 If possible record off VHF, because it's a higher quality signal end less 
susceptible lo interference. If (bars not possible then use long wave or 
medium wave. For frequencies see Ihe Radio Times. 

5. Use a direct connection between your tape recorder and the radio-. If 
you use b microphone someone's bound lo burst into the room ei the 
crucial momenir 

3. Set the recording level before the software is transmitted Don'1 Over- 
record as this may distoh the signal and the program might network. 

4. Use a shod lape if possible: Cf5 or C3fl. These are less likely to stretch 
and it can be frustrating look ng for programs on very long ropes 

Once you have successfully recorded the program on ihe iape you can 
load ii as you did wiih ihe demonstration programs. 

One final point. When the Dutch started broadcasting software on medium 
wave, they received reports of near perfect recordings horn Germany. 
Belgium. France, UK and Denmark We hope itiat the Takeaway service win 
be as widety received as possible, inside and oulside the UK. 

Writing BA Si CODE 2 programs 

Having run some programs in BASICODE 2 you might like tP write some 
programs. These will then run on any micro usmg the translation program. 
Because of the different BASIC dialects, you will need la write ihe 
programs according tp a set of rules, RASICODE-2 ensures that certain 
operaiions (like clearing the screen or moving the cursor \ will always work, 
no matter what make gf computer you use Details of how thas is achieved 
can be found in Chapier Three The programming r ules for your particular 
micro tan be found in Ihe relevanl chapter. Some micros have smaller 
memories than others, so you may Imd lhal very large programs doo'l run 
On all the machines 
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Chapter Three 

BASICODE -THE 
SPECIFICATIONS 


Tone Modulation 

Two tones are used to record daia onlo cassette tape, me frequencies ere 
1 £00 end SMW Hz. A "0" is defined as one full cycle of 1 200 H 2 . 

ru L_n 

A "1" ts defined as two lull cycles ol £400 Hz, 

run urn 

Sequence code 

The speed of BASICODE is 1200 Baud. A byte comprises Ihe following 
sequence: 

1 slaribit (logic Oi 

8 data bits I'lho least significant first} 

2 slgpbits (logic 1) 

Fdr exampfe 



BASIC information 

The B ASIC program is coded either in the lOrm in which it has been typed 
in. or as 1 is displayed on (he screen when, me command LIST is given, In 
mos! cases, however the is nil Ihe lorm in which it is retained in the com- 
puter's memory. 
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Ail lerters ciphers are presumed in American Standard Code for infor- 
mation interchange (ASCII), and each BASIC line is closed wiih Cfl (Hex 
3D). Each ASCN byte in the program receives an eighth bit 1. 

The tone sequence 

The cassette tape recording oF a BASiCQDE program Will consist Of: 

Leader: 5 seconds el siopbilf £400 Hj) 

ASCII Start Tear | Hbk. 02J 
BASIC Information In ASCII 
Checksum 

Trailer: 5 seconds of stopbitf 2400 Hi) 

Checksum 

A note about the checksum. This is a sample code used lo check mat the 
program has been read from the tape suocessluliy. II an error is indcsled 
by ihe checksum men BASfCODE 2 will tell you and you should list ihe 
program and correci ihe error. Then you can SAVE the program )n Ihe 
usual way. 

Technical note: ihe checksum Is a number stored as an £ bit computer 
word, tt is caicuJalod by performing an exclusive or on alt ihe previous 
bytes in Ihe block. Unlike all the other transmitted ASCII characters, (he 
Checksum's eflhlh tut is not set to "1" but may be"1" or "0". 

The Improved BASlCODE 2 

The 1 00a o( the first BASlCODE was to be able lo transmit machine- 
readable programs over the am For the mosl part this worked extremely 
wei> A program from microcomputer X could be read by computer V. 
simply by using the BASICQDE translation code tape in between. The 
regular transmission of BASlCODE programs Since W9 by the Dutch 
domoslic service iNOS) showed that BASlCODE was extremely rehabfe, 
often better than the computer's Own cassette interface standard. Radio 
amateurs m the Nether lands soon obtained permission from ihe Dutch PTT 
to expen menl with computer data transfer using BASlCODE. and excellent 
results have been reported using VHF links. 

However, the regular broadcasts also highlighted some ol the limitations of 
Ihe original BASlCODE, mostly as a result oi the various BASIC dialects. 
The rules of the original protocol -did not work in all cases. 

Bo. based on experience, improvements were made to the standard tq 
create BASICQDE 2. The working of various BASIC instructions was 
examined m the various dialects. (n doing so. many differences were 
discovered. However, there was common ground amongst the computers 


taking pert in the BASlCODE working group. 

All computers worked In Microsatl-BASlC, *r had the possibility ol doing 
so, A subsel ol standard BASIC instructions has now been drawn up. which 
has the same meaning in all Ihe various BASIC dialects. These are dealt 
wiih in more detail in the next chapter. There are also a number of very 
imporfant functions wh«h are brought into action using different 
commands on diflefenl: computers. These include (he clearing of Ihe 
screen and thecommands to a printer 

The solution in this ease is in the form of subroutines on agreed lixed 
BASIC line numbers. The subroutines are Ol course different for each 
brand of computer, but they all work in much the same way. The sub- 
routines are called when a particular function «s required. 

This means a new discipline in programming and the adjustment of 
existing programs to meel the new Standard. However, ihe eWort appears 
Ed be worth the trouble, smee BASlCODE 2 programs now work on marry 
brands ol computet without having to be adjusted by the user before they 
will run. 

The Subroutines are contained m ihe BASlCODE 2 translation programs 
ofi Side t as pad pi the loading sequence and therefore do not have io be 
part or baSicode 2 programs you exchange with other users. The 
cassette with this handbook contains the transition programs you will 
need in most cases it is possible lo choose whether or not the subroutines 
are read or recorded with the main BASlCODE program 

BASlCODE 2 is npw (he fruit oi soma years dF experiments -and ts a 
practical medium ol data transfer. It is a simple solution in cases where 
programs have 10 be distributed to 0 number of computer brands. 
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Chapter Four 

NOS BAS I CODE-2 PROTOCOL 

We have already explained the Esperanto concept of NOS- 
BASlCODE. and the idea or writing one program that can be of 
use to a number of different computers. What follows rrgw is a 
detailed description of the standard, designed for 
programmers who wish to use BASICODE-2 

1. BASIC ODE- 2; The ground rules 

There are four base rules- In Ihe BASlCODE-2 protocol: 

o. Wte only use BASIC statements mat are understood by afl elands of 
computers A list of those can bo found in section 5 ol this chapter. 

b- Smce rulo a. leads to a hot ct practice! problems. such as the inability to 
clear the screen in a standard way. Ime numbers below 1000 are reserved 
Tor subroutines These perform the extra Functions needed in most 
programs that cannot be achieved using the standard BASIC statements. 
The precise fungiion of these subroutines Is descri bed «n section 3. GOSU8 
100. for es* ample. IS used to clear the screen, GQSUB 110 puts the cursor at 
a specific point on ihe screen, and so on These routines are ol course 
Specific t-0 OflCh computer brand and therefore they are nOI part or the main 
program in BASICGDE 2 standard. They are therefore Intruded In the 
translation programs for each brand oi computer. When oomft.rted with the 
BASlCODE-2 data, the whole program is then complete. 

c. 'iVe have bo standardise the video display screen as consisting of 24 
lines, each of 40 characters. If you are programming in BASiCODE-2 then 
it is import ant that you bear the screen size in mind! Unfortunately ihe rule 
>s not quite as ample as this There are computers in the group with Only 16 
lines on the screen fe.g TASSO) and some that can only accommodate 22 
characters per line (e.g. ViC 20 1. Sc unless ii is realty necessary, do not use 
more than 16 lines on Ihe screen, and do not make lines fong«w than need 
be. Bader slilL use a subroutine which adjusts the lines to the size of the 
screen. This is possible using BA$ICODE-2 

d. A Ime should myt be longer than 60 characters Including ihe spaces and 
the line number, 

2: Tho program construction 

The following line number scheme is used to build up a B A Si CODE 2 
program: 

0-999' Standard routines isee section 3|. These routines are 
diderent for each computer and are therefore contained In 
the translation program. 
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1000: first line OF the BA&ICODE-2' program, it musi be in the 
following form: 1000 A {value}: GOTO 20: REM program 
name, (value} is the maximum number of characters |hei 
can be used try alt strings together. Line 20 i£ u£&d to 
reserve memory space for the strings In those compulers 
which need it 

1010-32767: the main program. There are no restrictions on this 
seclion, except that Ime numbers above 32767 are forbid- 
den. 

Although il is not compulsory,, u is a good idea to build up your 
BASICODE 2 program systematically. Olher users Can then quickly under- 
stand your method of working, and il is ihen easier to adapl if necessary. 
We suggest that you use the following scheme: 

1-000 ■ T9999: the main program. 

£0000-2^999: subroutines which you need Tor your program, but which 
contain stalemenis which are not allowed in BASICQPE 2. 

25000 - 29999: Unoswilh DATA statements 

30000 - 32767: lines with HEM statements. You can use Ihis space lor any 
background details about die program, refoences or your 
name and address . 

It is worth noli ng at Ihls point the use of the subroutine lines 20000 24999 
Try to avoid the use of statements that are net allowed in BASrCQDE 2. In 
some cases, of course, this is unavoidable, for example, ihe storage of 
variables on tape or disk. This is when you use the hnes 20000 24&90, It Is 
extremely important the! you indicate exactly whal these routines are 
intended lod*, or other brand users will nol be able io follow your fogc. It is 
else good practice to use line numbers in steps of 10. thus leaving plenty Oi 
room io msed lines at a laler stage. 

3. Operation of the BA SI CODE -2 standard routines 

These ere wrillen specifically for each computer brand and form part of Ihe 
translation program They look different in ihe various BASIC dialects but 
i n fact i hey do exactly the same in each case. 

GOSUBlOO: 

This Subroutine is used to clear ihe screen and sel the cursor al position 0,0 
|i.e. the fop leh-hand corner ol the screen, l 

GOSUB 110: 

This places the cursor ai a specific point on the screen. The exact point can 
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b<? Chosen by specifying Ihe variables HO and VE. HO is the portion on e 
line |0 is the furthest position to the ie+1}. arte VE is the numb® 1 of the Ime 
The lop line on Ihe screen is considered to be number 0. Remember thal in 
BASlCODE 2. ibe maximum screen sire is 24 lines, each of 40 characters. 
For ihis reason HO must not be larger than 39, and VE cannot be greater 
Ihuii 23. The variable’s HQ A VE are ngl changed in value on calling the 
subroutine, 

GO SUB 120: 

This gives ihe position of Ihe cursor on the screen and sets the variables 
HO and VE. HO 0 is Ihe first position on any line, and VE 0 im plies Ihe top 
Ime on the screen By using Ihis subroutine, and GOSUB 110; you can 
move the cursor about the screen. 

GO SUB 200: 

This Checks il a key has been depressed, and «r so. puts the character in 
the variable IN$. 11 no key was pressed Ihen INS is an empty string In 
principle it is possible to put any character on the keyboard into IN$. inelud- 
ir*g control characters. Bui be careful. Not a I control characters have Ihe 
same function oh different brands of computers. So il is tost to avoid 
control characters. The RETURN |or ENTER. NEWLINE, etc) key. though, 
does have ASCII code 13 on ell computers. 

GOSU6 21Q: 

This subroutine waits until a key bos been depressed and then sets the 
Character in the variable INS 11 differs from GOSUB 200 in that this sub- 
routine waits until a key has been pressed, whilst GOSUB 200 only checks 
whether o key has been depressed. 

GOSUB 250. 

i hr . is used to activate the Peep on most computers with this facility. Nate 
'i n ihe pilch and length of the tone is not specified in Ihis rouime, and 
therefore n >s not suitable lor making music. 

GOSUB 260: 

This gives a random number in ihe variable RV. The number is always 
smaller than t and larger man. or equal to, O. Il is a useful rouime in 
statistical programs or tn games. 

GOSUB 270; 

This tidies up me variable space and reports how much memory space is 
SliJI available. ThO variables are rrol erased!! The number or Tree bytes over 
is placed in the variable FR 
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GOSUB 300; 

This creates a string SRS using the value ol the variable SR. This string has 
no space* al either me beginning or the end of the number, m contrast lo 
(he BASIC statement STRSt f. In some BASIC dialects il does contain 
spaces, so me statement ST R$( Hs thus forbidden in BASlCODE 2. 

GOSUB 310: 

This, routine creates a string SR$ which is determined try the variables CT, 
CN, and Sft. SfiS Is equivalent In value to the variable SR and is always in 
Tbted-poinl natation. The total length of SH$ is thus CT characters, ol which 
CN Characters come after me dec-mpl pe-nt If Ihe number does na -1 fil into 
Ihe given lomn. then Sft$ will consisl ol Cl asterisks. If necessary. SR will be 
rounded gH The variables CT, CN end SR ere not changed by calling this 
routine Here are a lew examples 

CT 7: CN 3: S R 2/3: GOSUB 3t0 gives S RS as 0.667' 

CT 0: CN 5: SR -1 IE-3: GOSUB 310 gives SRS. as '-COCuiCT 

CT 3: CN 0:SP 23.6: GOSUB 310 gives SR$ as "24" 

CT 3: CN 1: SR 100: GOSUB 310 gives SR$ as ‘ ■" 

GOSUB 350: 

Prims SRS- on me pnnler. but does not close that particular line. Thus you 
can print more than once per line using this particular subroutine, But 
.remember that nol all users have a printer and so try 10 include a choice in 
your program between using the punter or Ihe screen display. 

GOSUB 360: 

Closes the line qci the printer and begins with a new line. 

4, Variables 

There ate a few reslridioos govern ng the use Of variables m BASlCODE 2 
programming. This is necessary to make Ihe exchange between diHerent 
brands as simple as possible 

a Numeric variables are real and single precision Do rial COuht an preci- 
sion greeter than 6 places of d ecitnal. 

b. Names SOr variables should be 5 minimum of Iwo characters long. The 
tirsi character must be a teller, the second character |ir used) can be either 
a letter or a number. The names of the variables should be written using 
BLOCK CAPITALS. Small tellers are not allowed. In Ihe case of string 
vanaWes, me name is always followed by a $. All other characters, such as 
!,. # , or ^bare forbidden. 
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C Logic var li Lmaa are those which are "true' or "false"- You are not allowed 
to use the numerical value ol the logic variables. The is because In some* 
esses the "irue" is inter preted as + f r in other computes as-1. The rasull 
can only be used in an IF. . .THEN construction {i.e. A 3* {5 1) is nod 
allowed), 

d. Betore a variable is used, it must be given & value. Do not assume Ebsl a 
variable is automatically given a isro value at the start of the program. 

e. Tbe maximum siring variable lenglh is 255 characters. 

f Names of variables may net begin with the lefler 0- These are reserved 
for u SO within the BA5JCQDE 2 standard routines, 

g. T!he fdllOwmg variables are excluded: AS: AT; FNj GR; IF. P| I ST; Tl; Tt$: 
TO 

h. For communication With the 6ASICODE-2 Subroutines use is made of 
the following variables: HO: VE; FR SR; CN; CT; FtV; INS: SR&. 

5 BASIC s tale-men ts and operators 


ABS 

INPUT 

RESTORE 

AND 

INI 

RETURN 

ASC 

LEFTS 

RIGHTS 

ATN 

LEN 

RUN 

CHRS 

LET 

SON 

COS 

LOG 

SIN 

DATA 

MIDI 

SQR 

DIM 

NEXT 

STEP 

END 

NOT 

STOP 

EXP 

ON 

TAB 

FOR 

OR 

TAN 

GOSUB 

PRINT 

THEN 

GOTO 

READ 

TO 

IF 

REM 

VAL 

+ 

A 

< > 1 

- 


<* J 

if 

< 

>= 1 

i 

> 



Above we have listed the BASIC commands and operators, most of which 
can tK3 used withdul any problems in BASICODE 2 programs. We have no 
intention at this pqinl to examine In full each Of the commands and 
operators Many books have already been written on the subject, However 
we have decided to give a short summary since there are a lew restrictions 
on certain BASIC commands in BASICODE 2. 
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BASIC commands and l heir meaning 

A&3 Gives the ab&atulo value al i he slated variable. For 

example: 


A 10: B AE3[A) 

A ^£0:6 AB&l'A) 
A -1:B ABS|A.S> 


B is now 1 0 

fl IS now 20 

6 pS h&w G 


Logic AND, can only be used Tor logic variables The rosull 
is a lOgscal result, Use brackets lo Show* clearly me Order in 
which the work is ed be done Examples: 

IMA 5|ANO{6 &UHEN 
Q (A.&fANDjB CfclFQTHEN, 

This gives the ASCII value OF the first character Ol the given 
siring, Examples.* 

A$ A":B ASCfASf Bis now 65 

A3 '6EEFT';B ASC(A$) Bisnow §6 

Gives the arctangent in- radians ol the given variable. For 
example 

PRINT ATNil) 

0-7S539& 

PflFNT ATNt-1) 

-O.7353&0 

This gives a character with the same ASCII value as the 
given var iable The variable can be anywhere between 32 
up to and including l£7. fle very careful w'-th values less 
than 32. Since control characters on d-rtereni brands gl 
computers vary. Only the RETURN key always has tho 
samp value. ASCII code 13. In addition not all computers 
recognise lower case letters. So t M 3 careful with ASCII 
codes larger than 96 For example. 

A$ CHRS(66l AS now contains Ihe letter E 

This gives the oosme ol Ihe given angle in radians For 
example: 

PRINT COSt 1) 

540302 


After this term will follow numbers and/or slnngs until the 
end Of Ihe I ne, which can be read using READ On a DATA 
line there should tie no olher slatemenls such as REM. 
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The elements should bo separated by a comma. String 
variables must be placed between quotation marks.. For 
exampia 

DATA 100,200, "HELLO", "BASlCOOE".4.&.B9 

DIM This statement is used to dimension arrays. An array can 

onty be dimensioned once in a program, and belgre il is 
used. The maximum number of dimensions rs two. whilst 
the maximum number pf elements is I imtad by the Size or 
ihe memory. One DiM statement can be used for more 
than one array. Eul there are lw& points to note: 

1. In some computers arrays up to 10 element d0 ngt 
nave to be dimensioned in BASICCDE 2 programs, an 
array must always be di mer sioned . 

2, The element with num ber 0 is also allowed . so A(0) and 
AD$|'Q,0J do exist For example: 

DIM ASf1SKHD(tt». 100), MPjlOOty 

END Used tg indicate the end of a program Do not just let a 

program stop. Always finish wit h an END statement. 

EXP Raises Ihe number «{ 2.71020 . no a specified power. For 

example: 

PRINT EXP(2) 

7.30SQ6 

FOR TO STEP NEXT. Program’ k»p ccmSIruiitiOrt. The loop will be used 
at leagi once. STEP can be left out. in which case the step 
is automatically 1. NEXT must only be followed by a single 
variable Fgr example: 

FOR X-fD TO K>0 
Program in loop 
NEXT X 

FORC A TO ESTEP -3 
Program In loop 
NEXT C 

FORI 1 T0 10 FOR J 1 TO 5 
Program in loop 
NEXT J;NEXT| 

Note: don’t jump out oF s FCR-NEXT loop before K Hhs 
ended A way to end (bo loop is by raising: the variable lo 
exceed Ihe end point. 
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GOSUB Used to call a subroutine a no indicated by the line number 

tolkswing the statement. For example: 

GQSU&10Q. 

Note, though . that A 100:G OSU B A is not allowed 

GOTO indicates a ju m p to a given line number. For example 

GOTO 1500 

Note, though . that A 150O:GOTO A is nol allowed. 

IF. .THEN Conditional split, tor between IF and THEN will be logical 

variables or logical comparison's. II ihe logic is "true" then 
the process continues through to statements alter THEN it 
nol. then the computer simply moves to the next line. A 
line number may be given after THEN, from which the 
program should continue. Note Lhat ELSE islcrbidden in 
BASlCOOE 2. For exampie: 

IF A JTHENB 0: C $ 

IF A> 3 THEN 1500 
C CA>3J:IF C THEN GOSUB ICO 

Note; 

Use IF..THEN &000 
and not: IF. GOTO 2000. 

Use IF .THEN GOSUB 2000 
and not. IF. GOSUB 2000. 

IN PUT Ask s the user Lo input eilher anum ber Of a string variable. 

A. string may not gonsisl ol eimer commas or colons If 
commas or colons are needed, tnen n is better to make 
use Cl Subroutine 210. A prompt String s no: allowed, and 
neither -s more than one variable after an INPUT. Most 
BASlGs print a -question mark, on the screen to show thai 
inpul is requ red In gome computers, when the RETURN 
key & pressed, the nne Irom the test curso* point to the 
end Of the line IS erased. Examples 

PRINT "WHAT’S YOUR NAME" INPUT NS 
PRI NT "KEY VAL UE IN INPUT A: IN PUT B 

But notell 

INPUT ’IfOUR NAME .AS fe forbidden 

INT Grves the largest whole number (integer) less than or 

equal to the given variable. Far example: 

A 2.1: B INT<AJ B is ngw 2 
B NTH, 5| & is now -2 
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LEFTS Used to select a number el characters from a given string 

starting wllh the character farthesl to the left. You may 
select a minimum ol 1 character up to the maximum 
number of characters mthe string. For example: 

A$ LEFT$( 'BASICQDE",5) 

AS. now consists of "BASIC”'. 

But note that CS LEFTS ( " B ASICODE 0) is not allowed 

LEN Reports the length of a g iven string. For example 

AS "BA5ICODE ,r : A -LEN(AS) A is thus G 
AS _ :A LENfA$) A is tfru&Q 

LET The variable name tell of the equal sign is assigned the 

value of the string or expression to the right Of the equal 
sign li is not really necessary, since LET A Sis the same 
as A 5. 

Calculates the natural log ol the given variable or expres- 
sion. For example: 

PRINT LO<j<1) 

0 

PRINT LOG(lG) 

2.3P2SSS 

Takes a number or Characters from a siring. MID£(A$.X,Y) 
gives Y Characters from AS. beginning with the Xlh 
character Note that the first character is number 1. so X 0 
Or Y 0 is forbidden. For example: 

AS 'THIS IS GASICODE" 

BS MID$tA5,9. 0) 

B5 now consists of "GASICODE" 

NEXT Closing statement for a program loop i see .FOR). A NEXT 

statement must always be folio wed by a variable 
Exam pies- are given under FOR 

NOT Logic negation, only unable cm logic variables <&S* at SO 

AN DU. For example: 

A S:B NOT (A 6) B is "true" 

A [5 5) 6 NOT A B is "raise" 

OM GOSUB,- 

QM..G-GFQ Makes a jump to either a subroutine or a program tin*. 

After ON follows, an expression *r variable. After GQ5UB 


LOG 


MfD$ 
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Or GOTO follows a series of line numbers The expression 
or variable should be a whole number and determines 
which line (lumber is to be chosen. You can think ol the 
line numbers- at having numbers rf Ihe variable is i than 
the first ime number is chosen, if the variable is 2 then the 
second line number h& chosen, etc. But the variable cannot 
be greater than the number of nno numbers given. For 
exam pier 

ON K GOTO i TOO. 5400. 1500 K has to be 1, Z or 3 
QNtK-SjGOSUB 600, 700, 300 K has lo be 6, 7, pr 0 

OR Log ie OR can on ly be used with log ic variables (see AND). 

For example: 

IF A-5 OR B<3 THEN... 

C-(A-S) OR (6 < 3): IF C THEN.,. 

PRINT Prints a variable or a string on the screen beginning at the 

present cursor position. More than one variable in a 

PRINT statement must be separated by semi-colons. If it is 
not desired that the computer should automatically 
continue witn the next line ihen the end ol the instruction 
must be finished off wth a semi-colon. Same computers 
print one or move space? before and/or after the 
nnmbens) being printed. If you do not want this, then use 
subroutine 30Q or 310. For example: 

A 5tAS= , "HELLO“: PRINT A AS 
&HELLQ 

PRINT 'HELLO": PRINT "THERE" 

HELLO THERE 

CN 3;CT 5 SR 5:GOSUB 31D:PRINT"FIVE ";5F$ 

FIVE 5.000 

READ Reads the elemenis alter the DATA statements and gives 

them to variables) Which tallow the READ stalemenl. 
Mora than one variable after a READ statement should be 
separated by commas. After the RUN command, the 
compuler will read the DATA start ng urlh the lowesl line 
number. All data on that line will be read fterora continuing 
wilh any other DATA lines. But note: A numeric variable 
musl read only numbers,, a string vanaWe can only read 
strmgs. Fa* example: 

DATA 1, "COMPUTER", 3 
READ A. AS HEAD BOT 
READ AHEAD AS READ B or 
READ A. AS. B 
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flUN 


SIN 

SGN 


soft 


This is ■usetf lor adding REMarlts in Ihe program 10 help 
other users undersiand what you arc doing, Anything ^ftier 
a REM statement until the end erf the line is ignored in 
BASIC by the compiler Bui do not use a colon after Ihe 
REM statement as Ihis gives problems with some com- 
puters, 

This statement lesets READ-ing From IftrS First DATA Slate- 
mem in the program, Gut nole that you may nai give a line 
number after a RESTORE Statement, 

Is used to indicate the end of a subroutine. The computer 
then jumps back la the tine alter the respective GOSUB 
statement that started the subroutine sequence. A sub- 
routine should always be closed with a RETURN state- 
ment 

Gives 5 number gl characters 01 U given Siring, ending 
wilh the Iasi character The minimum number ihkl can be 
asked is 1, the maximum being the length Of the String. For 
example 

AS BASICODE : B$ RlGHT$fA£.4) B£ now consists o» 
-CODE". 

Bui note that A$ PROTOCOL": A 0 &S RIGHT$(A$.A) 
is not allowed because A Q. 

Slarls the program afresh, while all variables are erased- 
Note that a hne number after RUN is not allowed For 
example: 

IF (AS "J' 1 ) OR {AS YJ THEN RUN 
Ngle lhal RUN 100 is lorbiddert. 

Gives Ihe sine al a variable Which should! be given in 
radians 

See COS for lurthar details, 

Is used to give Ihe sign ol a variable, i,e. -1 II Ihe variable is 
negative, 0 d the variable is zero, and ► 1 pF the variable >s 
positive. For example: 

A 5:B SGNCAf Bis now 1 
A • -.001 : B SGN(A| Bis hOW-1 

Calculates the sguarp,“ root of a variable or expression, 
which cannot be negative. Fox example. 
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STEP 


A 5QR(2’S0} A is now 10 
Sets the step size in a loop . See FOR, 


STOP Stops Ihe program, but retains ihe possibility oi going 

further, keeping the same variables. 

TAB 1$ used in PRINT slatemenls to move ihe cursor to a 

specific poinl on the screen. You can only use TAB to 
move ihe cursor further on a line, and depending on Ihe 
computer, either spaces win bo prated or whatever is on 
the line will be kepi. Note ihat TAB(O) is not allowed 
Although most computers start counting from 0. there are 
those that start al 1. So tor this reason it is belter to use 
subroutine tig. For example: 

PR!tfT"A"; TABfSJ; "B"; TAB(tO); "C" gives: 

A B C on some computers and. 

ABC on others. 

TAN Calculates the tangenl of a given angle in radians. See 

COS. 

THEN See IF. 

TO See FOR 

VAL Gives the numeric VALue of a string. But if the string is not 

purely numeric, the result is ngi the same on ell com- 
puters. For example: 

AS "1.4E6" A VALIAS F A is now 1.4EG 

A$ "120": A VAL(AS) A is now undetermined. A 12 or 

A 0 being possible. 

Summary 

Now follows a short summary gl ihe operators allowed in 
SASlCOOE-2. 

+ In ihe case of num bars of variables this operator adds two 

numbers Or variables together. In the case or Strangs, two 
are coupied to each oihex For example- 

B 1 : A 3 - 9 A is now 10 

AS "BAS'": G$ "lCO":C$ "DE.": 

D£ AS-BS*CS 
□S therefore is "BASICODE.". 


BASICODE - THE PROTOCOL 23 


- Rub'racls two number^ or variables Irom each other. Fu r 

example: 

A 10-3-4 Ai$now-3 

' Multiplies two numbers or variables together. For 

example: 

A 5:0 3* 2* A Bisnew-.=30 

/ Divides two numbers or variables. For exam pie: 

A 5:B 100/ A/2 Bi$now^10 

Raises a number or variable to a spot Led power. For 
example: 

A 2:6 16:0 A A B C r£ now 65536 

Logic operator: indicates equality between (be two ex pnes= 
sions or either side of it. See also AND. 

On the variable name to the (eft of the equal sign is 
assigned (he value of the string or expression to the right 
of the equal sign. Examples: 

A (5 -S( A is '"false” 

A 4 '6 Aignow 24 

A$ "HELLO" A$ now oontams "HELLO" 

< Compares two numbers or expressions and checks 
whether itie one to (he left ot the operator is less in value 
than the- one to (he nght The result is therefore a logic 
variable. If stri ngserebeing compared, then the siring to the 
left of the operator is checked to see il it comes earlier in 
alpha -numeric: Order than the String to the right, Tfou can 
use this operator for alphabedcal sorli ng. For example: 

A 5:0=|A<7} Bi* ,, trLja" 

AS ~W:B$ "HA": A (AS<B$} A is thus '‘false - 

> Ideniical to < except that the test is now "greater than" or 

"laler" in alpha-numeric order. 

< > Checks la see whether two variables or expressions are 

"un-equal", The result «s a iog*ceJ value. For example:: 

A (9< >7) A is "true" 

AS "HO - : B$ "H" A [AS<>B$| A is therefore True" 
FFA< >5THEN ... 
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< - Less than or equal Ip. For the Function of |hig np-eratpr see 

<, but substitute "less than or equal to" In place of less 
than". 

< Greater than or equal lo. For (he fondion ol Ihis operator 
see > , but Substitute "greater than or equal tig" in place of 
"greater than", 

Note; When using the lagl three operators the order of the 
two characters n Important For example: A- >5 is wrong 

We trusl the BABICQDE £ protocol is explained clearly 
enough, and we look torwarq to your program contribu- 
tions. For details of how tp contribute, see Chapter One. 

Jfocham Herrmann 


1 

I 
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C hapter Five 

APPLE II & lie 


BASlCODE is an encoding standard created to allow Ihe rnierchanging of 
program; written in SASIC, between different brands Of computers. The 
program ksbng is recorded on lape in ASCII using a special standard 
palled BASICOD? This program makes it possible lo reud and write 
standard BASICODE through the cassette recorder interface. 

Ng changes are required lo the Apple nor to tbe tape-recorder connec- 
tions. You can start ngnt away! The program functions with or without DOS 
and is independent of the size Of the memory. However, at least 1&K RAM 
and Applesoft either m ROM or in Ihe language card are required. 

The BASICODE 2 system 

To transfer programs from one computer to another, without too many 
problems, ihe software must meet some special requirements. Briefly, it 
amounts to the fact that a number of BASIC statements may not be used, 
end some- Others only with certain limitations. Instead you wifi nave a 
number of subroutines replacing these statements. 

Each computer has Its own routines. A program consists ngw of Twg parts: 
firstly, a machim-dependem part, different lor each computer, and 
secondly. Ihe main program, which is identical lor all computers The main 
program always starts al line iOOQ, and uses the subroulmes located batow 
I ne 1Q00. The Apple standard Subroutines have been included in this 
program, liYhat ihese subroutines do*, end hgw |g use mem, >5 described in 
Chapter Three. 

Only the main program needs to be transferred, since ihe subroutines are 
Contained in the BASIC ODE 2 translation program which you already 
have. Prior to loading a 8ASICODE 2 program you must have loaded the 
subroutines. 

How to use this program 

By typing 4 and then RETURN you will gel the man menu displayed on the 
screen- Prior to read mg in a 6ASICODE 2 program you can enter me sub* 
routines by Typing 1. You can check the subroutines by typing LIST. In tbs 


manner you can also load ihe subroutines if you warn to wriie a program 
using BASICODE 2 standards. 

Option i loads a program from tape, and option 3 saves a program on 
tape. A detailed description of the load and save options now follows. 

The loadi ng option 

After typing 2 you W«N SCO ’START THE RECORDER AND TOUCH ANY 
KEY 1 on Ihe screen. Start the tape with (he BASICODE program and as 
soon as you hear the header tone, touch any key (the header (be tone at 
the start). With the proper tape level Ihe screen shows ‘HEADER POUND'. 
The computer loads from the tape, indicated by the hashing characters at 
the extreme tpp right of the screen. Alter deteciign of the trailer tone, and ir 
all is welt, you will see the program l isting start lo scroll on the screen. 

The newly loaded program is Pa^ng added to what is already stored in the 
memory, af errors occur during loading, the loadrng process will not stop at 
the trailer. Press control C; the screen will now display 'LOADING ENDED' 
Mowed by a selection menu. Typing I results In a !«tmg or ihe program 
read. This listing can be stopped by touching any key. 

Pressi ng the SPAC E key wi ll restart the Jisling, any olher key halts it, If there 
ard not too many errors, the program may Still be entered by typing 2. Later 
on you can cornecl «t yoursolt Whan there are loo many errors, it is better ic 
lype 3. return lo BASIC and iry another load with a different volume setting 
at the cassette recorder. 

ir ihe program is too large lor your Apple. Uhe load slops with MEMORY 
FULL' and 'LOADING ENDED'. Ydu can then start to follow Ihe interrupted 
load sequence jusi described. 

Tbe write option 

By lypmg 3 in Ihe main menu you will be shown ihe next menu page. 
Again there are three possibilities: option 1 checks lor maximum line length 
of 60 characters. This, includes a space after the fine number and a space 
belqre the keywords. TO', ’STEP'. THEN', ’AND'. 'OR', GOTO' and 1 'GQSUB', 
These spaces are automatically added by Ihe save option. 

The program is also checked for control characters. The numbers of the 
lines containing errors are displayed on the screen, Ihe lines can be 
corrected before saving on tape. Option 2 saves ihe program on lapo 
Sterling ai fine IQOfl, Ihe BASfCODE 2 SubrOutrnes are nol included. Oplion 
3 saves The entire program, which in fact contradicts the BASICODE £ 
protocol 1 However il a useful contradiction, 
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Before writing, a teble is generated followed by Ihe rr u ay age START THE 
RECORDER AMD TOUCH A NV KEY”, 

A her lau&hirg the key, the recording is started; when you hear the beep the 
save process is complete, if the memory sse of you* Apple is too small to 
star? the program and Hie table, the program will be erased to make 
space. 

In this case, you will see 'BASIC PROGRAM OVERWRITTEN'. IT the table 
size is such lhai it cannot lit in your memory, you wilt see "OUT OF 
MEMORY ERROR' The program has been erased, but you can divide it in 
sections which, alter save and load, may be merged. The memory size of 
mosl Apples is sufficient, so it will not be very often that you need to do this. 


Chapter Six 

BBC MICRO (MODELS A & B) 


You will find two translation programs For the BBC- Micro- on the cassette. 
The f*TSl Is the Load program end the second allows you to Save programs 
that you have written ki 0ASlCODE*2. Both the programs are written in 
assembly language for optimum efficiency and the code occupies (he 
mem ory addresses Immediately below the screen memory When running 
BASIGODE 2. HIM EM should not be changed and the m»cro should always 
be In MODE 7. 

It is not necessary to toad bolh the Loaid program and the Save program 
into memory at the same time. Normally you wll be using the Load 
program to translate programs that you have recorded from Radio 4 . Once 
the programs are translated, you can save them as BASIC programs in the 
normal way and load them again without using the BASIGODE -2 Load 
program. 

The Load program 

Once the Load program is in memory, type RUN. The screen will then 
display a reminder of what to type in Order to load a BASICGDE-2 
program. 

Remember that before yew load m a new BASEQDE 2 program, typo 
NEW To load a program, sal the tape at the beginning -of the leader tone 
and type in CALL A7AOO, As the program is being loaded it will be listed on 
the screen, If there is a problem during the loading you will get the message 
'CHECKSUM ERROR'. LIST the program to find the error and correct it. It 
the program loads without problems, type RUN to sol the program going. 

Whan you want lo toad a new BASICODE-2 program, press the ESCAPE 
key, type NEW and then proceed as before. 

Apart from the mam translator, (he Load program also contains the 
BASICODE-2 subroutines The loading process puts the subroutines 
below screen momory. following the machine code When a BASIGODE 2 
program is being loaded, the subroutines are copied to PAGE and Ihen the 
BASIGODE 2 program is copied ir-om the tape to follow the subroutines. 
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Once you have Successlully recorded the BASlCODE 2 programs oFP your 
radro and loaded them into your micro, you should SAVE them as ordinary 
BASIC programs. 

The Save program 

This translation program is provided in case you want to write your own 
programs and save them In the 6ASICODE-2 standard, il you have 
Followed the BASIC ODE 2 programming yu defines given in Chapter Four 
then you will be able to transfer the programs to a variety of other micro- 
computers. So. lo save your programs In the BASlCODE £ standard, 
LOAD the Save program into the micro and RUN il. This win compile the 
code and place H below screen memory. When the prompt appears on ihe 
screen, type NEW and LOAD your BASIC program. Whan the program has 
loaded, type CALL &7A03 if you went to save the program and the sub- 
routines or CALL 67 AM) f you just want to save the program on its own. 
Now set up the cassette recorder to record the BASlCODE 2 program and 
press RETURN You wtll see five seconds o! dots on the screen as the 
leader tone is being recorded, and there is a further Five seconds oi dots 
after the program has been transferred, w Fieri the trailer tone is recorded. 

tF there are any lines longer lhan 60 characters the Save program will mark 
therm with a V in tha 6isl character After the program has been saved, (he 
number ol lines marked is displayed on the screen. 

Note: The BASlCODE program Is generated by converting the BBC BASIC 
keywords ta ASCII code using the LIST command. The OS WORD vector is 
altered to pass the i nterpreter 

L.1QQ0, 

if only the BASIC program is to be saved or 
L 

if the BASIC program and subroutines are io be saved. In changing the 
OSWRCH vector the program inspects Characters as Ihey are sem to the 
screen by the LIST command. The relevant characters are then also sent lo 
the cassette port. 
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The instructions in this chapter apply to the following Commodore com- 
puters: 

CBM-3008.JQ1S and 3022 i w th new RO.Y1 si 

CBM-4016 and 4Q32 

CBM.0O32 and 9096 

Commodore 64 

PET- 2001 (with oW ROM's) 

VIC-20 

Mroductfoti 

The reading and writing of programs in the BASlCODE 2 standard is 
possible via the use of the translation programs supplied with this 
handbook. Each of the compu ters mentioned above has a separata ban- 
station program spegrtic&Hy designed for that modal. The translation 
program checks that II is berng loaded into the correct model, and it not, il 
will automatically stop and give a relevant instruction. The working of the 
translation prognam s slghlly dilferant wiih each model, However, as far as 
the user is concerned, the Inspections which lolkrw apply to all Com- 
mudere models. H there are com mania specific to certain models, these 
appear on the screen. 

There is no no® d to make any changes to your computer to use 
BASlCODE 2, since the programs work With the standard hardware 
supplied by the manufacturer. 

Description of the accompanying cassette translation program. 

Proceed as follows; lira! LOAD the specific BASlCODE 2 translation 
program, for your model Of computer. Whan this is complete, type in the 
command RUN whereupon a menu Will appear on me Screen. You new 
have actioice of two Functions: 

t Preparation Of the Heading program to read a BASEODE 2 program 
Tram tape. 

2 Preparation of the Writing program to pul a program In BASlCODE 2 
onlo tape. 
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Once you have chosen a number. We selected program is prepared in the 
top 5-12 bytes of the available computer memory. Whrlp this is happen mg. 
you will &ee a counter displayed on We screen which follows (he progress 
of this preparation process When the counter reaches D. the job is 
complete and the relevant translation program is reedy. On the screen you 
will see which SYS instructions you can call up. Wb suggest you wr ite Wese 
down on a piece oi paper, since you can use these instructions ai any time 
unlit you swilgh the computer off 

The chosen translation program is in fact laken from the strange texts in 
ihe DATA knos end convened into machine language. This is then placed In 
the top 5i2 bytes of the memory, and the available space for BASIC 
interpretation is therefore reduced by the same amount 

After noting the SYS instructions, if you than press the SPACE key, the 
menu appears again, tf you w«h to load the- other translation program at 
this point, you may do so. However, if you are using either a VlC-ZO, or a 
PET wilh limited memory capacity, than it is advisable la load She second 
translation program only when it is needed. 

If you have already lisled the program as read Irdm we cassette. you may 
have been surprised by the rirst 50 lines. These era the fixed subroutines 
described m Chapter Four, These are used In all BASICQDF £ program?, 
so be careful Wat you do nol erase them by accident with Ihe use of NEW. 
You win probably need these routines at a later stage. 

Reading BASlCODE t programs 

Wilh the lursl SYS instruction displayed on the screen after setting up ihe 
Reading program, you can start up the BARCODE 2 Reading program. 
The memory is then cleared Irom line t000 onwards, -where Ihe 
BASlCODE 2 program will be stored. If you ore using eilher a vie -20 or a 
PET. Ihpn the statement 'READY' will appear on the screen, after wh ch you 
should type In the second SYS instruction. With me Commodore 64 and 
CBM 3000 and higher the program automatically goes further wiLhout a 
second instruction. The screen now disptayg an instruction to press the 
PLAY button on the cassette tape-recorder. As soon as this is done, the 
statement SEARCHING FOR BASlCODE' or simply 'SEARCHING' 
appears The computer now looking for the header tone on (he laps 
Anything which does noi resemble a header tone isuch as Speech before it) 
■s Ignored 

When the header is itscaled. Ihe computer wilii i nd rcaie 'FOUND' and will iry 
lo load Ihe BASICODE program ir you are using a Commodore 64 
computer, then at this poinl the screen will go blank. This is normal. On the 
other computer? you will see flashing characters si the lop cl we screen 
This is text being read from (he tape, and allhbugh it goes v*fy last, you 


may be able to follow some of IL As soon as everyihing has been read. We 
recorder will slop and ihe computer gives the statement 'READY'. In We 
case or we Commodore 64 computer, the screen wil l mow return Eb normal. 
You can now LIST the program il you wish, RUN it. or otherwise adjust It. 

If something has gone wrong during ihe reading process, then after ihe 
recorder has stopped, the statement 'LOAD EHROR' will appear. On Ihe 
PET Ihis is simply displayed as 'ERROR' -Despite Wis though. everything 
Kh? been road from tape, so by listing you can check whewer ihe program 
can be corrected. 

Errors such as ‘PRUNT" instead of 'PRINT' should show up clearly, II lor any 
reason you wish to interrupt the loading process, press the STOP key 
whdh will glop your tape recorder. On some computers you may meed lo 
press Wo STOP and RESTORE key. The section which has been read from 
tape, up to the interruption, has been stored. You can then type further lines 
in the normal way. 

II desired, the loading procedure can be slarted using ihe second SYS 
instruction which appears pm (he screen, In the case, everything which is 
already in the memory remains untouched: the computer simpfy puts what 
it reads from the tape alter what is already in the memory. So bo careful 
lhai lute numbers are in ihe right sequence, il you are doing this 
deliberately otherwise you will have problems running ihe program* 

The Reading program checks to see Jr there is sutfitienl memory during (he 
reacting process. If Wis. is not the case. We loading process stops and ihe 
statement 'OUT OF MEMORY ERROR' appears. The program on We tape 
is Wen too large for your computer mem pry. 

The Reading program makes use of ihe (first) cassette buffer during 
roadr ng of a BASlCGDE tape. 

Because Commodore computers work with upper and lower case letters in 
a non-ASCII way, the Reading translation program offers twD methods of 
processing lower case letters from the tape. One possibility is Wat lower 
case tetters art the cepe are convened to 'Commodore' capital letters. The 
other alternative is thaf -lower case loners wil l be convened to 'Commodore' 
lower case letters, and capitals i-nto 'Commodore' capitals. The latter is 
perlarmed only when fetters arem Strings, r.e. between inverted cpm ms? 

To inform the Reading translation program MOW to proceed, ybu iWuSI set 
your computer either in text mode or in graphics mode. The computer will 
then adjust the incoming program io We mode you havo selected. If you sei 
the computer to recognise both upper and lower case letters, incoming 
programs will be presented with both typos as appropriate. However, this 
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may no* always fro the most desirable (orm, H it is not, then you can try 
again using the graphics mode. 

Writing in BASICODE 

Lilia the Reading program just described, the Writing tran&laltou program 
is desrgned io resemble the ordinary SAVE as much as possible. You can 
slarl the Writing program us-mg Ihe SYS instruction which appears Oh the 
screen alter you have loaded It. Before you can save »n BASiCOQE ol 
course, you will need to load the program that is to be saved in the 
BASICODE formal. When this is done, you can then; select the su table SYS 
Instruction and ihe computer wm ask you to press the record buttons on 
yOuir cassette recorder. Once you have done this, the computer will then 
stan to save the program on tape using me BASICODE standard- In the 
case ol the Commodore 64 computer, ihe screen will go blank duemg this 
saving process, Fn the case or other computers, you will see flashing 
characters in the top teit hand comer of the screen, indicating what is being 
saved on tape. After lha last character $ seconds ol trailer tone is 
recorded The recorder then stops and the statement READY appears. On 
the Com modore 64 , the screen then becomes active again. 

Points to bear in mind! 

In order for this system to work, you must follow these guidelines for 
BASICODE: 

1 A program line may not be longer than 60 characters in lengm it you try 
to make it longer, then the Writing translation program will Stop the saving 
process when you iry to save your BASICODE program, n will give the 
statement 'LONG LINE ERROR IN..." followed by the line number in 
question. LIST this line number, make il shorter. Or Split it in two using two 
line numbers, Then you can use the SYS instruction to re-save the 
BASICODE program. 

2, Those characters which you see m reverse-iieid on the screen, such as 
dear-screen and all graphic characters are forbidden in BASICODE f they 
appear in your program, then as you try to save it in BASICODE,, the 
process will stop. The statement 'ILL.CHFl ERROR IN will appear, 
logettier with the &ne number of ihe offending character. ILL.CbR. simply 
stands Tor ILLEGAL CHARACTER. 

If you decide lo save in BASICODE using the graphics mode. Ihen alt letters 
■n your program will be saved as upper case. IF you use the text mode, then 
upper end lower case letters ih&t appear in strings will be saved without 
any change. PET owners can thus save a program using BASICODE 
knowing that it will appear in the cor reel lorm on other Commodore com- 
puters as wen, 
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There is a possibiiily Ihal the statement TLL.CHR.ERROR IN ...' may appear 
when there does not seem to be anything wrong. It may be mat you have 
made a space by pressing ihe SPACE Car while In Ihe shift mode. Simply 
re-type the spaces, making sure you use the SPACE bar in its normal 
sotting. 

3. Remember that the trailer tore IhsIs five seconds, so make an allowance 
for this on Ihe cepe, if Ihe tape is loo short, the computer may (nr lo pul this 
onto the plastic leader at the end of your tape. 

Ybu should see now that (he tirst SYS instruction means that only line 
numbers lOQO and above are saved on tape, following the BASICODE 2 
protocol. The second SYS instruction gives you Ihe option lo save every- 
thing, 
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Chapter Eight Chapter Nine 

SHARP MZ80A SINCLAIR ZX81 


The BASlC-ODE translation program for the Sharp MZ&0A is clearly 
dan'll ad on Side 1 of the cassette tape. I| is celled BASIC ODE 2 5510. 

0& nidi use lines 1 to 100C; these are reserved far a subroutine handling 
command. LOAD/2. This command ensures subroutines necessary for 
BASICODE 2 are added lo the program being loaded From cassette. 

You should remember ihls when saving a program m BASiCODE-2, The 
command For Lh s Opera lion is SAVE/B10OQ 

Using the command SAVE/SltlOCk lines lOdOand above will be saved onto 
cassette in Hie BASlC-ODE rDrmat. But before Ihe 'RECOflO PLAY’ instruc- 
tion appears on me screen, me compuler will ch-ec* the program you wish 
to save. IF there are fines that are 60 characters, or longer, in length, then 
thal line will be printed on Ihe screen The transition inlo (he SASLCODE 
formal will slop. You should now make the I me shorter (by splitting over two 
i ns numbers], and then give the command SAVE/B100Q- 

Yeu do have the oplion to save ihe eniire program on tape, tF desired. IF you 
use SAVE/B you will achieve this. Atl the usual commands you are used to 
remain unaffected by ihe BA&ICODI system So II ts also possible lo use 
the LOAD and SAVE functions if you wish. 

We wish you success wilh the BASlCQDE-2 system and look Forward to 
your contributions to the broadcasts. Details df howto participate are given 
In Chapter One. 


Introduction 

The Translalion program on the cassette is the lelest addition lo Ihe 
BASICODE system although the ZX8i has been available for some years. 
There have been two major problems lo overcome: 

1. Memory capacity: Esrty models did not, have enough space For Ihe 
translation program. This problem has now been -largely overcome with the 
availability of more memory. 

2. The Sinclair BASIC: Thre type of SASIC used in the ZX8i is not 
immediately comparable with the form used in BASICODE-2. The Sinclair 
ZXSI is hot able lo cope with- more- than one statement per line whereas we 
flowed this in BASICODE lo avoid Fong programs, 

How to use the Translation program 

Lead the program on Side 1 ol Ihe cassette for the ZXBl, Use LOAD " to do 
thrs. The program consists or two routines, Ihe Reading routine designed lo 
make the ZX01 read the BASICODE program oH Ihe radio, and the Transla- 
tion program to convert what has been reed into e form thal can be dealt 
with by IheZXBL 

After loading ihe program, the routine should present itself end the ZX81 
will give an error message 7/909CJL Thi* is normal. Your ZXfll is now 
operating the FAST mode which is essential for ihe Reading routine. 

You are now ready lo load a program recorded on the radio. Remember to 
keep the recording levels as high as possible, without distortion. Having got 
a recording, wind it back lo the start and cue up the cassetle so that you 
can hear the start tone. This is the steady tone thal starts all BASICODE 
programs. 

Now type in RAND USR 16619 

Start your tape recorder m ihe playback mode and press (NEWLINE}. The 
BASiCODE program should now start loading. This process will slop if: 
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a) You p rest E R EAK 

b) The memory 13 full 

c! An ETXCHR t& loaded. 

Now type in UST 999 and on that line you should see a REM statement. 
Whai comes after the REM has been loaded by |h# computer. 

H the RASiCOOE program hasn't loaded correctly, if may be due 10 ih# 
volume control on youi tape recorder being set loo low. This will result in 
meaningless information alter the REM On 30 m# or all lines. H the whole 
program is nonsense, start again from the beginning and try a differenl 
volume setting. If only the last part has gone wrong, tfiere is no reason why 
you shouldn'i start loading half-way through ihe BAS-CQDE program 
rather than winding i| back to Ihe start. It may take some experimenting at 
lirsi, but you should find a point where the process goes smoc-i hiy 

Now ihal we're in the position of having loaded the BASlCODE program, it 
haa to be translated into a form that the ZXSi recognises as an ordinary 
ZXSl program. You start this process by typing in RAND U&H 171 65 1 NEW 
LINE) 

The Translation program now Starts looking at the BASiCODE mpterlsJ, line 
by line. A statement is ragiaoed by a token and when it comes across a 
second statement on one line, it generates a new line for this second state- 
ment. LET and GOTO statements are inserted where necessary, and when 
this is oompieie. the REM statement is erased. You can tlweior# #nped 
the follow ng result 

Original After Loading From fl ad io New Version 

1210 REM A-40Q : B=2 1210 LET A -400 

1211 LET B-2 

1220 REM LET AS "ABC " : 0$ "FGH" 1220 LET AS "ABC" 

1221 LET BS "FGH"' 

1225 REM IF A B THEN A= 0 1225 IFNOT(A>0) 

PR INT "A WAS < > 0” : 1 300 THEN GOTO 1 230 

122B LET A 6 
1 227 PRINT "A WAS < > B 
1226 GOTO 1300 

1230 REM PRINT A: PRINT 6 1230 PRINT A 

1231 PRINT B 

1300 REM PRINT "END VB". AS 1300 PRINT "END VB", A$ 

You can lust this system Out by using RAND LiSR 16G10 (NEWLINE). 

You don't need a cassette, but you will need to press BREAK. You can now 
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type in a lew teat lines and have Them translated by entering RAND USR 
17165 If you press 8REAK during Ihe translation process, the computer will 
slop translating and you will once agism see the screen. You can go back to 
translating; by using RAND USA 1716S again and the computer will pick up 
where rt left off, 


Adjustments 

Once you have loaded and translated a BASlCODE program you can now 
try to RUN iL Some programs broadcast in The Chip Shop wilt run 
knmedigrtely. Gut there will also be a lew lhal need some changes to be 
made. These Changes wll become Clear during a test run. Type in RUN 
(NEWLINE) and note any error messages that come up, Check Ihe imo the 
computer refers lo. Remember that unlike other computers in the 
BASlCODE system, the ZXB1 does ng| like string variables and FQR-NEXT 
variables which consist of more than one character, eg, 'INS’ and "FOR 
IN OTO itT, You will have to change these to variables of a single character 
Instead. 

Suppose yOu Choose ZS IO replace INS in the program. That is tine, PS long 
ps ZS doesn'i appear elsewhere m the BASlCODE program with, or course, 
another meaning. So it's a good idea, once you have chosen your single 
character van able !q check that It doesn't csisl In the BASlCODE program. 
To do ihls type In: 

RUN soa-'r (ter search (for word) 

This simple routine now scans through ihe entire program and gives the 
message "FOUND" if it does iind, in (his case. Z$ If you donl get Ihig 
message, then ll is safe to replace lN$ in lira original by Z$. You do fills, by 
typing in: 

RUN m,-*r 1 lor replace), -INT {for word), ZT (replaced Dy}- 

Nde: The space before toe Z$ >s deliberate, Both the variables must be the 
same length, so when you pm the single character in. you must leave that 
space. 

DATA- RESTORE- READ process 

in most cases you car replace DATA by DIM DS (...,) LET D 1. You must 
work quI the dimensions of D$ The number of DATA elemenis is the first 
number, and Ihe length of Ihe tengeal element Is Eh# second. In addition. 
DS musl be filled wjih a number oi LET stetemenis. RESTORE thus 
bocomas LET □ 1 . and READ A$ becomes LET A$ D$(D) LET D D * 1 . 

in most BASlCODE programs, programmers tend to put DATA mio table 
term, and use statements elsewhere in Ihe program to manipulate iL 
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Before 

After 


2000 

FORM 1 TO ... 

2000 

GC-EUB 3000 

2010 

LET REA D Mf|Nj 



2020 

NEXT N 



3000 

LET DATA "WO' - , TTl r "WE 1 

3000 

REMMSm “MO": 


MSliJ-'TCMSO) "WE 
RETURN 

We don't need lines £000-2020 Ifi Ufte above example. Instead, the date is 
rewritten in another form in line 3000. ll we now start tip the Translation 
routine- using RAND li$R 17105. a number of neal lines will be made Irom 
line 3000. each wilh ns own LET statement.. 

Note Remember that some other computers allow me lable index to be 0, 
l.e. LET A${0)-“VB". 

AH we have to cheek now are LEFTS, MID5. and RIGHTS, 

LET AS "ABCDEFG" 

LETBS ,_EFT^A$,3) LET BS MlDS(A$.3.1} LETB$ RIGHTS AS, 4) 

BS is now 'ABC'' BS is now -’’C" BSijngw "D£F<jT 

But we could also write BS LEFTSfABCOEFG ",3), and so on, and get the 
same result Sofa* theZXSi this would become: 

LET B5- A$fTO 3k LET BS AH3T0 4) LET BS AS(LENAS-4| TO} 

Line number 933 is a very speeds ime. REM COPY COPY. Th»s is ihe ter- 
minator line and everything alter (he terminator line with a higher line 
number (l.e. larger than $ erased. You can change this line number rf 
you wish 

Note too mat ihe Reading routine will scrap any lines above 9390. and line 
numbers will move in steps of 10. 


Chapter Ten 

TANDY TRS-80 MODELS I & III 
VIDEOGENIE 


The BABICQDE Translation program has bean designed ter TR3-B0 
Models l and 1 III and Ihe Videogenie. However, you will need to construct a 
smaJI interface. This is noC all then difficult and should not deter you Irom 
going Further with the BASICODE idea You can also use BASICODE with 
orwlthouta risk drive, 
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The extension circuit board 

The circuit description IS given If! Figures 1 to 4, find in the circuit diagram 
(TRS-BO Fig 1) and you should note the following 

- LED off: There is no input signal 

- LED one The input signal is greater than 200 mV and the frequency 

is greater than 300 Hi. Without any input signal, DO 
remains high (i.e. logic t or hi-state). The current oon- 
sumpiifln gl tee printed circuit board is about 30 mA. 

Details of a suifable power supply are given in TRS -SO Figure 5 Bui teiswiti 
ngi be necessary rf you decide to m ount the prrnted circuit board inside the 
computer keyboard or expansion nterfece- The power- supply from the 
computer can easily cope w4h the extra power drain from this interlace. 
The printed circuit board layout is shown in TRS 80 Figure 2 and the com- 
ponent -details are noted in TRS -60 Figure 4. 

The printed circuit board for (his interlace is available ready-made. It may 
be ordered from the following address 

TRS 00 Users Croup. 

R.Q. Box 551. 

2070 AN Santpggrt, 

The Netherlands. 

The printed circuit board coats E2.00 including postage. Only tee printed 
circuit board is supplied not the components You should be able to 1-nd 
the latter in electronic com ponent shops or by m ai | order 

The BAS 1C ODE Translation program 

Load the Translation program Tor the TRS flfl/Videogenie which you wll 
imd on Side 1 ol the cassette. Thia is done In the normal BASIC mode, 
using CL0AD 

After you have typed in RUN. a menu will appear asking you which 
computer model yOu are using. It you follow the instructors cn the screen, 
you should end up with the Translation program ready for use. Dnceyou 
have done this. STORE the adjusted Translation program either on disk or 
cassette. Use this modified program as your BASlCODE 2 translator from 
now pn, 

Using the Translation program 

When you wish to use BASlCODE again, load the modilied program back 
into the memory using CLQAD- or LOAD, as appropriate. After you have 


RUN lit, you w4l see the sEHlemeT! 'READY' appear on the screen. The 
Translation program is now ready for use. and you have 1019 bytes of 
memory Spade lees than normal. 

The following commands are now available: 

-SET: YOu use this for loading a BASlCODE formal program 

from tape into the computer. 

The normat BASIC is unaffected by the BASlCODE translation program m 
(he memory, You can stall load TRS BO tapes using CLOAO. save using 
C5AVE in TRS-flO lormal, etc But note: If you have a program in the 
memory, and then toad the BASlCODE Translation program, you will lose 
your original program. So save it frrst usmg CSAVE or SAVE- 

The extension circuit board Interface should be connected lo Port t$, bit 0.. 
A 40 way connector is then used to make a connection to tee bus located at 
the back -or (he computer (Port 255 bit 0 & 1). 

Loading programs in BASlCODE 

In order lo be able to load a BASlCODE program from cassette lape. you 
will need one of the interfaces described above. Note that the loading 
routine does not give a NEW command* so if you are |ust starting to load a 
BASlCODE program, first type in NEW, If you do not, than the BASlCODE 
program wtU be merged* m the same way as when you use the disk-BASlC 
marge commands. Remember this, especially if you want to put programs 
together end eventually re-number tee result 

You start the loading process by using tee command GET. The cassette 
recorder will now start and the program lines will appear at tee top of the 
screen, it the memory capacity is insufficient, tee statement 'MEMORY 
FULL' will appear and the tape wil slop. Similarly, if you press BREAK 
during the loading sequence, the statement 'BREAK IN PROGRAM' wilt 
appear and tee (ape will slop, if there is a reading error, teen you will see 
CHECKSUM ERROR' appear. But, usually, no statement wii appear, and 
the recorder will Shut off when it reaches the frailer tone on the tape. 

You now have the following options: 

BREAK- The input or programming will stop and tee > prompting 

KEY cursor will re-appear You use this it there is a problem 

with tee program you have just loaded. 

ENTER - This Ime will be accepted Into the memory, 

KEY 
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BSPACE - This tine will not be accepted into the memocy. (or example 
KEY if there is a fault m the li ne- number. 

SPACE- IF you press this (or (he ENTER key) repeatedly. the 

BAR program is read in at full speed. This is useful when the 

program cor 1 . 0 ms no lauits, 

The pressing of ENTER or B5PACE automatically brings up (he next line of 
(he program f« inspection, 

H there are control characters in [be program (other than Cfl or ETX|, or 
(here is a reading error (stapbit not a "T or bit 7 nol a "I"}, then (he 
character In question wit be underlined using a V You can use (his facility if 
you are trying to rescue a program from a very poor quality tape, in con. 
junction wth theedrt facility. 

You can also load from a tape more than once. ad| usting trw playback level 
to different sellings until a complete program is obtained. If (he ’MEMORY 
FULL’ statement appears, some ol (he program wil have been loot, but 
what has already been put into the memory remains there, and can be 
used. 

The saving routine lor BA5IC0DE 

You do not need (he special interlace (0 save a program in (he BAStCQDE 
lormsl, You can begin ihe saving process by using the command PUT. The 
program is then saved onto cassette in ths BASlCQDE formas end the tape 
will start enigmatically. If the statement ‘MEMORY FULL appears, then the 
program was not completely stored in the memory, due to lack of space. 
WFval was stored will be put onto (ape. You can only interrupt the saving 
process by pressing ihe reset button at (he back of the computer. Note trial 
control characters in ihe tent, such as T will not be destroyed, so make 
sure (hat they do net appear in your BABIQQDE programs, Or yOu may put 
other brands ot computers i nto tilt Read Chapters Two or Three for details of 
the guidelines to tolkwwith the SASICOi>E. NkrtethafthecammandGET will 
not affect other brands. 
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Ch spier Eleven 

THE FUTURE 





Singe details of BASICQDE spread outside The Netherlands, the Dutch 
have received many thousands of letters, it became clear that ihe most 
popular computers in one eounlry may not even exist in another. The idea 
of putting the entire BASICQDE 2 protocol into Chapter four is nol only to 
explain it to usars or computer makes already in the group, but it is hoped 
that experienced users or other makes WIH Study the protocol and create 
translation programs for their computer If you succeed, please do not 
keep il to yOurietff 

We will publish updates to Ibis handbook with details of translation 
program? for other brands. Authors are always credrted. and details of how 
to take part are given in the lirsl chapter of this book. 

BASiiCQDE has grown from a simple idea for exchanging software, baefc In 
1979, to a slandard in regular use in many pads of the world We hope you 
will contribute to make it even better known. 


THE FUTURE At 


